home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / BackgdErr.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tk_BackgroundError(3) Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_BackgroundError - report Tcl error that occurred in back-
  12.      ground processing
  13.  
  14. SYNOPSIS
  15.      #include <tk.h>
  16.  
  17.      Tk_BackgroundError(_i_n_t_e_r_p)
  18.  
  19. ARGUMENTS
  20.      Tcl_Interp   *_i_n_t_e_r_p   (in)      Interpreter  in  which  the
  21.                                       error occurred.
  22. _________________________________________________________________
  23.  
  24.  
  25. DESCRIPTION
  26.      This procedure is typically invoked when a Tcl error  occurs
  27.      during  ``background  processing''  such  as executing a Tcl
  28.      command in response to a button press or menu entry  invoca-
  29.      tion.   When  such  an  error occurs, the error condition is
  30.      reported to Tk or to a widget or  some  other  C  code,  and
  31.      there is not usually any obvious way for that code to report
  32.      the error to the  user.   In  these  cases  the  code  calls
  33.      Tk_BackgroundError  with  an _i_n_t_e_r_p argument identifying the
  34.      interpreter in which the error occurred.  Tk_BackgroundError
  35.      attempts  to  invoke  the  tkerror Tcl command to report the
  36.      error in an application-specific  fashion.   If  no  tkerror
  37.      command  exists,  or  if it returns with an error condition,
  38.      then Tk_BackgroundError reports the error itself by printing
  39.      a message on the standard error file.
  40.  
  41.  
  42. KEYWORDS
  43.      background, error, tkerror
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.